home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 1324 / readme.txt < prev    next >
Text File  |  1997-05-14  |  18KB  |  417 lines
  1. ===============================================================================
  2. Win32 Console ToolBox, Version 1.0                   Last Updated: May 15, 1997
  3. ===============================================================================
  4.  
  5. This readme contains the following information:
  6.  
  7.     1. About the Win32 Console ToolBox
  8.     2. Overview of command line syntax
  9.     3. Help for DeTab
  10.     4. Help for ErrMsg
  11.     5. Help for FileCase
  12.     6. Help for FileType
  13.     7. Help for Global
  14.     8. Help for NewLine
  15.     9. Help for ShutDown
  16.    10. Help for Touch
  17.    11. Help for WebCat
  18.  
  19.  
  20.  
  21. ===============================================================================
  22. 1. About the Win32 Console ToolBox
  23. ===============================================================================
  24.  
  25. The Win32 Console ToolBox consists of nine freeware tools developed for the
  26. Windows 95 and Windows NT operating systems.  All tools were developed by 
  27. Steve P. Miller.  The latest binaries for these tools, as well as many other
  28. applications, can be found on my web page at http://pobox.com/~stevemil.
  29. Please mail any bugs or suggestions to stevemil@pobox.com.
  30.  
  31.  
  32.  
  33. ===============================================================================
  34. 2. Overview of command line syntax
  35. ===============================================================================
  36.  
  37. I have made every effort to standardize the command line syntax for all the
  38. tools in the toolbox.  The following rules apply to all tools.
  39.  
  40. - Running any tool with a /? option will display the full command line usage.
  41.   For example, "detab /?" will display the complete help screen for DeTab.
  42.  
  43. - All command line options can be specified with either a leading / or -.
  44.   For example, "detab /?" is equivalent to "detab -?"
  45.  
  46. - Options that do not take extra arguments can be grouped together.
  47.   For example, "detab /s /h /r *" is equivalent to "detab /shr *"
  48.  
  49. - Options that do take extra arguments can be placed at the end of a grouping.
  50.   For example, "detab /s /h /r /t3 *" is equivalent to "detab /shrt3 *"
  51.  
  52. - Spaces are optional between options and their arguments.
  53.   For example, "detab /t3 *" is equivalent to "detab /t 3 *"
  54.  
  55. Many of the tools take one or more filespecs.  A filespec can be any
  56. combination of a file, path, directory, or wildcard search string.  Here are
  57. some example filespecs:
  58.  
  59. .                 matches all files in the current directory.
  60. *                 matches all files in the current directory.
  61. *.exe             matches all files with ".exe" extension in the current dir.
  62. a*.xl?            matches all files in the current directory that start with
  63.                   an "a" and end with ".xl" followed by any single character.
  64. readme            matches a single file named "readme" in the current dir.
  65. c:\bin\*          matches all files in the c:\bin directory.
  66. c:\bin\           matches all files in the c:\bin directory.
  67. c:\bin            matches all files in the c:\bin directory.
  68. c:\bin\.          matches all files in the c:\bin directory.
  69. c:\bin\readme     matches a single file named "readme" in the c:\bin dir.
  70. d:*               matches all files in the d: drive's current directory.
  71. \\server\share\*  matches all files on the specified network share.
  72.  
  73. All tools that take filespecs also support recursive directory processing.
  74. Just add a /s to the command line of any tool, and that tool will expand its
  75. file matching search to include all subdirectories under the initial directory
  76. for that filespec.  For all the examples above, the /s option would repeat the
  77. search described for every subdirectory under the starting directory.
  78.  
  79. All the tools are smart enough to break apart the path portion of the filespec
  80. from the file or wildcard portion.  A filespec like "/s c:\bin\readme" will find
  81. all files named "readme" in the c:\bin directory and in subdirectories under
  82. the c:\bin directory.
  83.  
  84.  
  85.  
  86. ===============================================================================
  87. 3. DeTab
  88. ===============================================================================
  89.  
  90. Description: DeTab replaces all tab characters in one or more files with 
  91.              spaces.
  92.  
  93. -------------------------------------------------------------------------------
  94.  
  95. DeTab for Win32, Version 1.0
  96. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  97. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  98.  
  99. Usage: detab [/s] [/h] [/r] [/p] [/q] [/a] [/b] [/t size] filespec ...
  100.  
  101.   /s Process subdirectories.
  102.   /h Process hidden/system files/directories.
  103.   /r Convert read-only files.
  104.   /p Prompt for each file to be converted (Yes/No/All/Quit).
  105.   /q Quiet mode; Only display errors.
  106.   /a Treat all files as text files.
  107.   /b Create backup files.
  108.   /t Tab size (default is 8).
  109.  
  110. By default, any non-text or binary files will be skipped.  Use the /a option
  111. to override this behavior and force all files to be converted.
  112.  
  113.  
  114.  
  115. ===============================================================================
  116. 4. ErrMsg
  117. ===============================================================================
  118.  
  119. Description: ErrMsg will display the system error message for one or more
  120.              Win32 error values.
  121.  
  122. -------------------------------------------------------------------------------
  123.  
  124. ErrMsg for Win32, Version 1.0
  125. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  126. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  127.  
  128. Usage: errmsg value ...
  129.  
  130. ErrMsg will display the Windows error message for one or more error values.
  131. These error values are usually obtained from the GetLastError() function.
  132. The error values can be either in decimal, hexadecimal, or octal format.
  133. All hexadecimal error values must be preceded with "0x".
  134. All octal error values must begin with a leading zero "0".
  135.  
  136. Examples: errmsg 2
  137.           errmsg 0x8001010D
  138.           errmsg 044
  139.  
  140.  
  141.  
  142. ===============================================================================
  143. 5. FileCase
  144. ===============================================================================
  145.  
  146. Description: FileCase will rename one or more file names and/or directory
  147.              names to uppercase or lowercase.
  148.  
  149. -------------------------------------------------------------------------------
  150.  
  151. FileCase for Win32, Version 1.0
  152. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  153. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  154.  
  155. Usage: filecase [/s] [/h] [/p] [/q] [/d] [/l | /u] filespec ...
  156.  
  157.   /s Process subdirectories.
  158.   /h Process hidden/system files/directories.
  159.   /p Prompt for each file/directory to be renamed (Yes/No/All/Quit).
  160.   /q Quiet mode; Only display errors.
  161.   /d Rename directory names as well as file names.
  162.   /l Convert names to lowercase (default).
  163.   /u Convert names to uppercase.
  164.  
  165.  
  166.  
  167. ===============================================================================
  168. 6. FileType
  169. ===============================================================================
  170.  
  171. Description: FileType displays the file type of one or more files.  For
  172.              executable files, it will give details such as 16/32 bit, 
  173.              console/GUI, CPU type, etc.  For all other files it will list
  174.              the registered system description for that type of file.
  175.  
  176. -------------------------------------------------------------------------------
  177.  
  178. FileType for Win32, Version 1.0
  179. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  180. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  181.  
  182. Usage: filetype [/s] [/h] [/e] filespec ...
  183.  
  184.   /s Process subdirectories.
  185.   /h Process hidden/system files/directories.
  186.   /e Only display executable files.
  187.  
  188. -------------------------------------------------------------------------------
  189.  
  190. FileType displays detailed type information about one or more files.  While 
  191. listing files, it automatically identifies which files are executables and 
  192. which files are not.  FileType does not just look at the file extension; it
  193. actually examines the contents of the file to determine if the file is an
  194. executable and if so, what type of executable it is.  Therefore, FileType will
  195. detect all executable files, regardless of their extension.
  196.  
  197. The following is a list of executable formats recognized by FileType.
  198.  
  199. Architecture: 16-bit, 32-bit
  200. Platform:     DOS, Windows, Window CE, OS/2, POSIX
  201. Subsystem:    native, console, graphical (GUI)
  202. CPU:          x86, MIPS R3000, MIPS R4000, MIPS R10000, MIPS (big-endian),
  203.               DEC Alpha, IBM PowerPC, Hitachi SH3
  204.  
  205. For files that are not executable, FileType will scan the registry for the
  206. description that is registered with the system for that type of file.  For
  207. example, "Microsoft Word Document" might be displayed for a file ending with
  208. ".doc".  These descriptions may vary from computer to computer, depending on
  209. what software is installed.
  210.  
  211.  
  212.  
  213. ===============================================================================
  214. 7. Global
  215. ===============================================================================
  216.  
  217. Description: Global makes any application or utility recursive.  It will 
  218.              recursively execute any command in the current directory and in
  219.              all subdirectories under the current directory.
  220.  
  221. -------------------------------------------------------------------------------
  222.  
  223. Global for Win32, Version 1.0
  224. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  225. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  226.  
  227. Usage: global [/h] [/p] [/q] [/i] command [args ...]
  228.  
  229.   /h Process hidden/system directories.
  230.   /p Prompt for each directory to be processed (Yes/No/All/Quit).
  231.   /q Quiet mode.  Does not display each directory name before processed.
  232.   /i Ignore exit codes.  Default is to exit if command returns non-zero.
  233.  
  234. Global will execute any shell command, shell alias, or application, in the
  235. current directory and in all subdirectories under the current directory.
  236.  
  237. Examples: global copy *.gif c:\gifs\
  238.           global if exist README start notepad README
  239.           global /hi grep "TO-DO" *.c* *.h* | more
  240.  
  241. -------------------------------------------------------------------------------
  242.  
  243. By default, Global quits whenever a command it runs returns a non-zero return
  244. value.  A non-zero return value from an application usually signifies an error.
  245. Use the /i option to force Global to ignore return values.  At any time while
  246. Global is running, you can press CTRL+C or CTRL+Break to stop further directory
  247. processing.
  248.  
  249. Note about piping and redirecting: The Global utility and the command it runs
  250. are usually treated as a single unit by the shell.  This single unit is then
  251. attached to any pipe or redirection that you may be using.  You may use quotes
  252. to group the command with the pipe or redirection to override the default
  253. behavior.  Here are some examples:
  254.  
  255.    global /hi grep BUG *.c* *.h* > bugs.txt
  256.  
  257. This example will create a single file named "bugs.txt" in the directory that
  258. Global was executed.  To the shell, the command looks like the following:
  259.  
  260.    (global /hi grep BUG *.c* *.h*) > bugs.txt
  261.  
  262. If you would like the redirection to occur on a per directory basis, you can
  263. group the command and the redirection in quotes.  The following example will
  264. create a "bugs.txt" file in every directory that Global processes:
  265.  
  266.    global /hi "grep BUG *.c* *.h* > bugs.txt"
  267.  
  268. To the shell, this quoted command essentially looks like the following:
  269.  
  270.    global /hi (grep BUG *.c* *.h* > bugs.txt)
  271.  
  272.  
  273.  
  274. ===============================================================================
  275. 8. NewLine
  276. ===============================================================================
  277.  
  278. Description: NewLine converts one or more text files to use a single LF or a
  279.              CR/LF sequence to end each line in each file.
  280.  
  281. -------------------------------------------------------------------------------
  282.  
  283. NewLine for Win32, Version 1.0
  284. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  285. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  286.  
  287. Usage: newline [/s] [/h] [/r] [/p] [/q] [/a] [/b] [/1 | /2] filespec ...
  288.  
  289.   /s Process subdirectories.
  290.   /h Process hidden/system files/directories.
  291.   /r Convert read-only files.
  292.   /p Prompt for each file to be converted (Yes/No/All/Quit).
  293.   /q Quiet mode; Only display errors.
  294.   /a Treat all files as text files.
  295.   /b Create backup files.
  296.   /1 Ensures that all lines end with a single LF.
  297.   /2 Ensures that all lines end with a CR/LF (default).
  298.  
  299. By default, any non-text or binary files will be skipped.  Use the /a option to
  300. override this behavior and force all files to be converted.  NewLine will not
  301. modify any line in a file that already uses the requested newline sequence.
  302.  
  303.  
  304.  
  305. ===============================================================================
  306. 9. ShutDown
  307. ===============================================================================
  308.  
  309. Description: ShutDown allows you to automatically log off, shut down, reboot,
  310.              or power off your system.
  311.  
  312. -------------------------------------------------------------------------------
  313.  
  314. ShutDown for Win32, Version 1.0
  315. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  316. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  317.  
  318. Usage: shutdown /l | /s | /r | /p [/f] [/q]
  319.  
  320.   /l Log off only.
  321.   /s Log off and shut down the system.
  322.   /r Log off, shut down, and reboot the system.
  323.   /p Log off, shut down, and power off the system (if supported).
  324.   /f Force all applications to close, even at risk of loosing data (NT only).
  325.   /q Quiet mode.  Do not prompt for confirmation.
  326.  
  327. ShutDown will attempt to safely close all running applications and flush all
  328. file buffers.  Any applications that do not respond or refuse to close will
  329. prevent logging off from completing.  The /f option will cause these blocked
  330. applications to be forcefully terminated without prompting, possibly causing
  331. any unsaved data in those applications to be lost.  Currently, the /f option
  332. is not supported by Windows 95.
  333.  
  334.  
  335.  
  336. ===============================================================================
  337. 10. Touch
  338. ===============================================================================
  339.  
  340. Description: Touch displays or sets the created, access, and modified times of
  341.              one or more files.
  342.  
  343. -------------------------------------------------------------------------------
  344.  
  345. Touch for Win32, Version 1.0
  346. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  347. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  348.  
  349. Usage: touch [/s] [/h] [/p] [/q] [/v] [/c] [/m] [/a] [/r file]
  350.              [/d mm-dd[-[cc]yy]] [/t hh[:mm[:ss[.ms]]]] filespec ...
  351.  
  352.   /s Process subdirectories.
  353.   /h Process hidden/system files/directories.
  354.   /p Prompt for each file (Yes/No/All/Quit). Ignored in view mode.
  355.   /q Quiet mode; Only display errors; Ignored in view mode.
  356.   /v View mode; Display times rather than set times.
  357.   /c View/set created time.
  358.   /m View/set modified time; Default if /a and /c are not specified.
  359.   /a View/set accessed time.
  360.   /r Reference file; Use this file's date and time to set other files.
  361.   /d Date: month, day, century, year.
  362.   /t Time: hour (0-24), minutes, seconds, milliseconds.
  363.  
  364. In view mode (/v), the /p, /q, /r, /d, and /t options are ignored.
  365. In set mode, the default is to use the current date and time.
  366. Use the /r, /d, and/or /t options to override the default set time.
  367. The century (cc) is assumed to be 19 for years 69-99, and 20 for years 00-68.
  368.  
  369. -------------------------------------------------------------------------------
  370.  
  371. You may notice that you are unable to set the date and/or time of a file to
  372. some exact setting.  It is possible that the operating system may need to round
  373. a value you have specified up or down to overcome limitations in the file
  374. system.  The following are some facts about FAT and NTFS:
  375.  
  376. FAT
  377.    Created time is accurate to the nearest 10 milliseconds (rounded down).
  378.    Modified time is accurate to the nearest 2 seconds (up on NT, down on 95).
  379.    Accessed time is accurate to the nearest day (rounded down).
  380.    Dates can range between 1/1/1980 and 12/31/2107
  381.    Dates and times are physically stored as locally adjusted times.
  382.  
  383. NTFS
  384.    Created time is accurate to the nearest 100 nanoseconds.
  385.    Modified time is accurate to the nearest 100 nanoseconds.
  386.    Accessed time is accurate to the nearest 100 nanoseconds.
  387.    Dates can range between 1/1/1601 and 9/13/30828
  388.    Dates and times are physically stored as UTC/GMT times.
  389.  
  390.  
  391.  
  392. ===============================================================================
  393. 11. WebCat
  394. ===============================================================================
  395.  
  396. Description: WebCat quickly generates an HTML page to catalog all your images,
  397.              animated icons, and other web related files.  Now you can easily
  398.              use your web browser to catalog all your content on one page.
  399.  
  400. -------------------------------------------------------------------------------
  401.  
  402. WebCat for Win32, Version 1.0
  403. Freeware by Steve P. Miller (stevemil@pobox.com).  Copyright 1997.
  404. Visit http://pobox.com/~stevemil for the latest version and other utilities.
  405.  
  406. Usage: webcat [/s] [/h] [/i] [/f outfile] filespec ... [> outfile]
  407.  
  408.   /s Process subdirectories.
  409.   /h Process hidden/system files/directories.
  410.   /i Only catalog image files.  Usually used with a filespec of "*".
  411.   /f File to save output to.  Default is to write output to console.
  412.  
  413. WebCat will output HTML source containing links to all the files matching
  414. the listed filespecs.  Files known to be images will be displayed as such.
  415. Image files include gif, jpg, jpeg, bmp, dib, pcx, png, tga, xbm.
  416.  
  417.